home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / convrtrs / pbmplus / manuals.lha / manuals / pgm / pgmcrater.man < prev    next >
Encoding:
Text File  |  1993-12-09  |  6.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      pgmcrater(1)         AMIGA (15 October 1991)         pgmcrater(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           pgmcrater - create cratered terrain by fractal forgery
  10.  
  11.      SYNOPSIS
  12.           pgmcrater [-number n] [-height|-ysize s] [-width|-xsize s]
  13.                     [-gamma g]
  14.  
  15.      DESCRIPTION
  16.           pgmcrater creates a portable graymap which  mimics  cratered
  17.           terrain.  The graymap is created by simulating the impact of
  18.           a given number of craters with  random  position  and  size,
  19.           then  rendering  the resulting terrain elevations based on a
  20.           light source shining from one side of the screen.  The  size
  21.           distribution  of  the  craters is based on a power law which
  22.           results in many more small craters  than  large  ones.   The
  23.           number  of  craters of a given size varies as the reciprocal
  24.           of the area as described on pages 31 and 32 of  Peitgen  and
  25.           Saupe[1];  cratered  bodies in the Solar System are observed
  26.           to obey this  relationship.   The  formula  used  to  obtain
  27.           crater   radii   governed  by  this  law  from  a  uniformly
  28.           distributed pseudorandom  sequence  was  developed  by  Rudy
  29.           Rucker.
  30.  
  31.           High resolution images with large numbers of  craters  often
  32.           benefit  from  being piped through pnmsmooth.  The averaging
  33.           performed by this process  eliminates  some  of  the  jagged
  34.           pixels  and  lends a mellow ``telescopic image'' feel to the
  35.           overall picture.
  36.  
  37.      OPTIONS
  38.           -number n Causes n craters to be generated.  If  no  -number
  39.                     specification  is  given,  50000  craters  will be
  40.                     generated.  Don't expect to  see  them  all!   For
  41.                     every  large crater there are many, many more tiny
  42.                     ones which tend simply to erode the landscape.  In
  43.                     general,  the  more  craters  you specify the more
  44.                     realistic the result; ideally you want the  entire
  45.                     terrain to have been extensively turned over again
  46.                     and again by cratering.   High  resolution  images
  47.                     containing   five   to  ten  million  craters  are
  48.                     stunning but take quite a while to create.
  49.  
  50.           -height height
  51.                     Sets the height of the generated image  to  height
  52.                     pixels.  The default height is 256 pixels.
  53.  
  54.           -width width
  55.                     Sets the width of the  generated  image  to  width
  56.                     pixels.  The default width is 256 pixels.
  57.  
  58.           -xsize width
  59.                     Sets the width of the  generated  image  to  width
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 12/9/93)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      pgmcrater(1)         AMIGA (15 October 1991)         pgmcrater(1)
  71.  
  72.  
  73.  
  74.                     pixels.  The default width is 256 pixels.
  75.  
  76.           -ysize height
  77.                     Sets the height of the generated image  to  height
  78.                     pixels.  The default height is 256 pixels.
  79.  
  80.           -gamma factor
  81.                     The specified factor is used to gamma correct  the
  82.                     graymap   in  the  same  manner  as  performed  by
  83.                     pnmgamma.  The default value is 1.0, which results
  84.                     in  a medium contrast image.  Values larger than 1
  85.                     lighten  the  image  and  reduce  contrast,  while
  86.                     values  less  than  1 darken the image, increasing
  87.                     contrast.
  88.  
  89.           All flags  can  be  abbreviated  to  their  shortest  unique
  90.           prefix.
  91.  
  92.      BUGS
  93.           The -gamma option  isn't  really  necessary  since  you  can
  94.           achieve  the same effect by piping the output from pgmcrater
  95.           through pnmgamma.  However, pgmcrater performs  an  internal
  96.           gamma  map  anyway in the process of rendering the elevation
  97.           array into a graymap, so there's no additional  overhead  in
  98.           allowing a user-specified gamma.
  99.  
  100.           Real craters  have  two  distinct  morphologies.   pgmcrater
  101.           simulates  only  small  craters,  which are hemispherical in
  102.           shape (regardless of the incidence angle  of  the  impacting
  103.           body,  as long as the velocity is sufficiently high).  Large
  104.           craters, such as Copernicus and Tycho on the  Moon,  have  a
  105.           ``walled plain'' shape with a cross-section more like:
  106.                           /\                            /\
  107.                     _____/  \____________/\____________/  \_____
  108.           Larger craters should really use this profile, including the
  109.           central   peak,  and  totally  obliterate  the  pre-existing
  110.           terrain.
  111.  
  112.      SEE ALSO
  113.           pgm(5), pnmgamma(1), pnmsmooth(1)
  114.  
  115.           [1]  Peitgen, H.-O., and Saupe,  D.  eds.,  The  Science  Of
  116.                Fractal Images, New York: Springer Verlag, 1988.
  117.  
  118.      AUTHOR
  119.                John Walker
  120.                Autodesk SA
  121.                Avenue des Champs-Montants 14b
  122.                CH-2074 MARIN
  123.                Suisse/Schweiz/Svizzera/Svizra/Switzerland
  124.                Usenet:  kelvin@Autodesk.com
  125.                Fax:     038/33 88 15
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 12/9/93)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      pgmcrater(1)         AMIGA (15 October 1991)         pgmcrater(1)
  137.  
  138.  
  139.  
  140.                Voice:   038/33 76 33
  141.  
  142.           Permission  to  use,  copy,  modify,  and  distribute   this
  143.           software  and  its documentation for any purpose and without
  144.           fee  is  hereby   granted,   without   any   conditions   or
  145.           restrictions.   This  software is provided ``as is'' without
  146.           express or implied warranty.
  147.  
  148.           PLUGWARE! If you like this kind of stuff, you may also enjoy
  149.           ``James Gleick's Chaos--The Software'' for MS-DOS, available
  150.           for $59.95 from your local software store or  directly  from
  151.           Autodesk,  Inc.,  Attn:  Science Series, 2320 Marinship Way,
  152.           Sausalito, CA 94965, USA.  Telephone:  (800) 688-2344  toll-
  153.           free  or,  outside  the  U.S. (415) 332-2344 Ext 4886.  Fax:
  154.           (415) 289-4718.  ``Chaos--The  Software''  includes  a  more
  155.           comprehensive   fractal   forgery  generator  which  creates
  156.           three-dimensional landscapes as well as clouds and  planets,
  157.           plus five more modules which explore other aspects of Chaos.
  158.           The  user  guide  of  more  than  200  pages   includes   an
  159.           introduction  by  James  Gleick and detailed explanations by
  160.           Rudy Rucker of the mathematics and algorithms used  by  each
  161.           program.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 12/9/93)
  196.  
  197.  
  198.  
  199.